{\rtf1\ansi\ansicpg1252\cocoartf1038\cocoasubrtf360
{\fonttbl\f0\fswiss\fcharset0 ArialMT;\f1\fnil\fcharset0 Verdana;}
{\colortbl;\red255\green255\blue255;}
{\*\listtable{\list\listtemplateid1\listhybrid{\listlevel\levelnfc23\levelnfcn23\leveljc0\leveljcn0\levelfollow0\levelstartat1\levelspace360\levelindent0{\*\levelmarker \{square\}}{\leveltext\leveltemplateid1\'01\uc0\u9642 ;}{\levelnumbers;}\fi-360\li720\lin720 }{\listname ;}\listid1}}
{\*\listoverridetable{\listoverride\listid1\listoverridecount0\ls1}}
\margl1440\margr1440\vieww15320\viewh19800\viewkind1\viewscale125
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural

\f0\b\fs24 \cf0 Axil Resources: A Brief Guide to Style and Localization\

\f1\b0\fs18 \
\
This document contains a summary of the rules and conventions used in the messages produced by Axil during compilation and script execution.\
\
\pard\tx220\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\li720\fi-720\ql\qnatural\pardirnatural
\ls1\ilvl0\cf0 {\listtext	\uc0\u9642 	}Use double quotes around all identifiers. For example, "shoe-size", not just shoe-size. Since the identifier is provided by the script writer, and not Axil, this gives an indication that Axil considers it external to its own system.\
{\listtext	\uc0\u9642 	}Do not place type names in quotes. Since the script writer will consider these part of the Axil language, messages should not place the type names in quotes. For example, "an integer value", not "an 'integer' value".\
{\listtext	\uc0\u9642 	}Use function(), not "function" when referring to Axil functions. This notation fits with the previous style guide and also indicates to the script writer that a function is being referenced. The functions are always listed without their arguments.\
{\listtext	\uc0\u9642 	}Use single quote characters around all character literals. For example, 'A', not "A". This provides a contextual clue to the script writer that the object they are dealing with is a character and not a string.\
{\listtext	\uc0\u9642 	}All messages in Axil are complete sentences. This is very different from typical languages, where terse, ambiguous or just plain confusing error messages are the norm. The Axil script writer is a casual or novice developer and these messages are one of the key mechanisms for exploratory learning. So, a verbose message, in a readable, grammatically correct form, is always preferred.\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural
\cf0 \
If you have any questions about these conventions, or are struggling to translate the highly technical nature of some of the Axil messages, please contact that Axil development team. We are happy to help the community.\
}